12.3 추심환율 획득(시스템 실시간)

#간단한 설명: 회수환율 인터페이스 받기 (시스템 실시간)

• 요청방법 : POST
• 요청 인터페이스: https://gateway-domain/wallet-trade-merchant/v1/utils/rate/receive
• 요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json

쿼리 매개변수

매개변수 이름	유형	필수	매개변수 의미	매개변수 설명
key	string	예	판매자 키	API키
currency	string	예	통화(주문 통화)	예: 위안화
userCurrency	string	예	사용자가 실제로 받은 화폐	예: USDT
sign	string	예	MD5 서명	자세한 내용은 서명 알고리즘(문서 2)

json 샘플 요청

{
 "key": "9yUreYgTRtit39Dy",
 "currency": "CNY",
 "userCurrency": "USDT",
 "sign":"dbc72adf640a82e0b21f98c50afb2881"
}

반환 값

매개변수 이름	유형	매개변수 의미	매개변수 설명
code	int	요청 상태	통신 상태 반환 성공: 0, 기타 실패 표시
success	boolean	성공현황	진정한 성공
message	string	설명
data	json	매개변수	매개변수에 대해서는 다음 설명을 참조하세요

예로 돌아가기

{  
    "code": 0,  
    "success": true,  
    "message": null,  
    "data": {  
      "baseCurrency": "USDT",
      "quoteCurrency": "CNY",
      "tradePair": "USDT/CNY",
      "rate": 6.68138724,
      "costRate": 6.68138724,
      "costReverseRate": 0.14966951683524932,
      "exchangeAction": "SELL",
      "quoteExpression": "1USDT≈6.6813CNY",
      "baseAmount": "14.966951",
      "quoteAmount": "100"
    }  
}

데이터 매개변수 설명

매개변수 이름	유형	매개변수 의미	매개변수 설명
baseCurrency	string	기본 통화
quoteCurrency	string	통화 견적
tradePair	string	거래 쌍
rate	string	가격
costRate	number	가격 계산( FROM x 요율 = TO )
costReverseRate	number	가격을 역으로 계산합니다(TO x rate = FROM)
exchangeAction	enum	거래 유형	구매:구매| 판매: 판매
quoteExpression	string	환율 표현	인용문의 표현
baseAmount	string	기본금액	예시 기본금액
quoteAmount	string	견적 금액	샘플견적금액